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ABSTRACT 


This thesis describes the design and implementation of 
a high level, general purpose, interactive graphics 
subroutine library for the Vector General Interactive Graph- 
ics Display System. The lower interface levels of the sys 
tem and its effects on the develooment of this high level 
interface are discussed. The problems and various 
approaches associated with the development of a general pure 
poser, high level applications subroutine library that is 
user oriented is outlined. The basic design agoalss solu 
tions and recommendations for further expansion of the sys 
tem are presented. This araphics subroutine library is 
imolemented within the conventions of the C=Programming 
language and the UNIX operating system as implemented on the 
PDP-11/50 in the Naval Postgraduate School Comouter Labora- 


tory.e 
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I. INTRODUCTION 


This thesis discusses the design and implementation of 
a high levels general purpose qraphics subroutine library 
for an interactive araphics display system. The subroutine 
library was designed to support the Vector General Interac- 
tive Display System (Vector General) [1], as installed at 


the Naval Postgraduate School Computer Laboratory. 


The Vector General represents a highly sophisticated 
graphics disolay terminal with hardware imolemented three 
dimensional rotation, translation and scaling. An 
alphanumeric keyboard, liqhted function switches,s, control 
dials and light pen provide the interactive tools of the 
system. The Vector General is interfaced with a PDP=11/50 


computer and is supnorted by the UNIX operating system. 


The actual desiaqn and implementation of this’ high 
level, general purpose interface is discussed as well] as the 
goals and problems encountered during it's development. The 
problems included providinq a user with the ability to 
describe and name picture seaments, desianing functions that 
would not limit the capabilities of the machinery and how to 
effectively utilize the existing interface levels. The main 
goal was the development and implementation of a simple, 


easy to user general purpose qraphics subroutine library. 





A user's manual was written, describing the imolemented 
library functions, so a user can easily utilize the qraphic 
capabilities of the Vector General) from a proaram written in 


the high level language, C [2]. This is included as Appen= 


dix A. 





fee CeserRrPIrON, OF THE VECTOR GENERAL 


The Vector General Graphics Display System is an 
interactive graphic cathode ray tube (CRI) display that is 
interfaced with a PDP=-11/50 computer. The display interacts 
with a user by displaying pictorial data, programmaticly 
described by the user, on the surface of the CRT. The sys- 
tem provides both hardware features and external contro] 
devices that can be utilized by a user to alter and manipu- 


late the pictorial data being displayed. 


A. HARDWARE FEATURES 


The cathode ray tube (CRT) is the most widely used 
Graphics display device and the one capable of generating 
and dynamically changing graphical data. The Vector Genera] 
display consists of a CRI and has many supporting hardware 
features (1,3). The hardware features provide, in addition 
to a vector generator, a circlewarce generator and a charac- 
ter generator. The system also has’ hardware’ implemented 
three dimensional rotation, translation and scaling. The 
features are controlled and coordinated by the Vector Gen- 
eral display controller. The controller is also responsible 
for handling communications with the external control deve 
ices. These external devices include an alphanumeric key- 


board, thirtyetwo lighted function switches, ten control 





dials, and a light pen. Figure 1 is a block diaaram of the 


Vector General Display System. 
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FIGURE 1 


Vector General Disolay System 
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ITI. EXISTING INTERFACE LEVELS 


The existing interface levels for the Vector General 
provide an efficient interface with the PDP-11/S50 and a user 
software interface package makes the detailed operations of 


the system transparent to the user. 


A. UNIX AND POP=#11/50 INTERFACE 


The Vector General is interfaced with a PDP=#11/50 come 
puter having 64K bytes of memory and up to sixteen million 
bytes of disk storage. The interface was designed to be 
used in the mutliprogramming environment of the UNIX time 


sharing operating system [4]. 


This interface provides the Vector General display pro-o- 
cessor with access to a 3eKk block of PDP=-11/50 memory. The 
Vector General display data 1S maintained within this block, 
and is continually accessed through a Direct Memory Access 
(DMA) channel by the Vector General processor in order to 
refresh the display screen. This approach frees the PDP- 
11/50 processor for other tasks, for example executing user 
proqrams. A detailed description of this interface design 
can be found in the Design Manual for the Vector Genera!) 


Display Unit [5]. 
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Perhaps the most important aspect of this interface is 
the resulting support of the Vector General by the UNIX 
operating system. This added dimension provides the graph- 
ics user with all the features of a general-epurposesr multi= 
US@r» interactive operating system in addition to the 


graphic capabilities provided by the Vector General. 


The UNIX operating system is desiqned to provide a user 
with a system that is simple and easy to use [4]. Within 
this framework extremely powerful features are available to 
the user. These include: a hierarchical file system, a sys- 
tem command language, compatible filesdevice and iintere- 
process I/O, over 100 subsystems includina MA i ROO: 
and the ability to initiate asynchronous processes. The 


system's primary hiaqh level languages are C and Fortran. 


These features of the UNIX operating system provide an 
efficient and flexible environment for a granohics user. The 
user has the facilities to maintain and manipulate Jarae 
Graphical data files. Communications links with devices 
such as tape drives and disks are easily established. The 
command language provides for the Pee eacan reading and 
writing of files and for transferring them between devices. 
An interactive text editor is available for program crea- 
tion, as is an interactive debugger for program debugging. 
These are only ae few of the extra facilities that become 
part of the graphic users environment due to this interface 


with UNIX and the PDP-11/50, 


ie 





Moving the Vector General from a self supporting stand 
alone graphics environments to one supported by a powerful 
operating system, greatly extends the resources available to 
the user. This extended system provides an environment for 
the development of a truely general purpose, high level 


graphics display system. 


B. LOWER LEVEL USER INTERFACE 


The existing user ‘interface software “package defines 
high level constructs which the interface routines convert 
to Vector General commands. These erakeuees define a 
hierarchical picture structure within which a user can iden- 
tify meaningful picture segqments. The three construct leve 
els defined by the softeware interface are: picturer object 


and element [6]. 
1. Picture Structure 


The construct level, oicture, refers to all the data 
that 1s to be displayed on the Vector General display 
screen. An element refers to the smallest picture entity 
that can be independently referenced and changed without 
affecting the remainder of the picture. Each element is 
defined by a series of Vector General display instructions. 
An object represents the lowest construct that can be 
displayed alone. Each object consists of one or more user 
defined elements. An object is indeovendently rotatable, 


translatable and scalable to any portion of the display 


rs 





screen. The picture defines the picture scale and screen 
coordinates for all objects. 


The generation and contents of the construct, pice 
ture and object are the responsibility of the interface 
software. A series of user routines are provided for the 
programmer to establish the desired object, element associa- 
tions. Additional routines are available to dynamically 


modify picture, object and element parameters. 


These three constructs orovide a logical base _ for 
structuring of pictorial data by a user. It does not, howm 
ever, produce an optimal user interface. The present intero= 
face provides no assistance in the creation of the display 
instructions that describe each element. The user 18s 
responsible for correctly dimensioning an array for each 
element and for filling it with the correct Vector General 
display instructions. These instructions require the user to 
scecify coordinate values with respect to the screen coordi-= 
mate system, and to specify coordinate registers and the 
desired action(i.e., loads, draw or move). This process of 
describing elements does not provide a user with a clear, 
simole and unified set of concepts for developing aqraphic 
disolays. It requires the user to concentrate on the graph- 
ics device, itS registers, coordinate system and capabili= 
ties and not on the picture that is to be created. The pro- 
cess is both tedious and errorsprone. The existing interface 
does not provide an optimal user enviornment, although it 


does offer a base for a higher level user interface. 
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2. Display List Structure 


The hierarchical picture structure orovided by the 
three construct levels ts supported by the implementation of 
a segmented display list [5]. This allows for the dynamic 
modification of each construct level which is a necessity 
for an interactive graphics system f7 1 A significant 
aspect of this implementation 1s that it supports the con- 
cept of shared display code. This is analagous to a convene 
tional subroutine call which allows sections of code to be 
used repeatedly. ThusSsr a user can define one element struc 
ture and by associating it with an object several times, 


cause the element to appear repeatedly in a picture. 
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IV. GENERAL INTERFACE DESIGN CONCEPTS 


The existing user interface levelsS SUPpOrting the Vec= 
tor General and the environment in which it resides has been 
briefly outlined. The present system does not provide an 
adequate interface, but does provide the base for the 
further development of the system. The environment created 
by the UNIX operating system also supports the concept of a 
high level graphics interface for the Vector General 
display. The tools for constructing a high level interface 
were available, the decision now was how to design an inter 
face package that could utilize the existing environment and 


orovide an optimal user interface. 


A. GRAPHICS LANGUAGE DESIGN 


In desianing a hiah level interface the main considera= 
tion is the develooment of a hiah level graphics programming 
language. The need for such a language for the construction 
and manipulation of aqraphical data cannot be overlooked. 
The ease with which a system can be programmed 1S a major 


factor in determining how a system will be utilized (8). 


A graphics language must provide a method for describing 
pictures (9]. The language must have facilities for 
describing not only nonegeometric entities in a simple form 


but also provide a way to describe two and three dimensional 
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geometric entities. Additional facilities should be avails= 


able for scalingr translation and rotation [(10). 


Developement of a hiah level language that provides 
these features can be approached in several different ways. 
A set of graphic functions or subroutines can be developed 
to be used by an apnolications program, written in a high 
level programming lanquage. Another approach is to utilize 
the high level languaae of the host computer and extend it 
to perform a variety of graphic functions. This extension 
can be accomplished by changing the existing compiler to 
handle graphics functions or by developing a preprocessor. 
If a suitable hiah level language is not available on a sys- 
tem, then the development of a language specifically for 
Graphics could be considered. This lanquage would require 
not only the development of graohic functions but must also 
provide alaorithmic-type statements, orocedufes or 


subroutine capabilities, and should be interactive [9]. 


The goal for the Vector General was the development of a 
high level aeneral purpose tltanguaae. The UNIX operatina 
system provided the high level lanquage C, that has facili- 
ties for handling many different data types, adequate con- 
trol structures and data structures for algorithm represen- 
tation. It also provides a simple subroutine calling format. 
Because of the Rr abia4 ty of the hiah level lYanguaae the 
develooment of 3 new graphics language was rejected. The 


decision was to either incorporate gqraphical functions into 


this host lTangquaaqe by extending the language or by 
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developing a subroutine library packaaqe. In General, 
severa] reasons can be stated for not selecting the 
subroutine library approach. These include the lack of con= 
venience of using subroutine calls exclusively, inefficient 
data structures provided by the host language, and lack of 
facilities in the host language to support a wide variety of 
applications [11]. The Celangquage provided al] the neces@- 
sary facilities and convenience. The simplest, and most 
logical approach was the implementation of aehigh level 
subroutine package utilized by an applications program writ= 


ten in C. 


The process taken in developing this subroutine library 
is outlined by W. M. Newman and R. F. Sproull ([1e] 3: 
1. Select a suitable language on which to base 
the system. 


ec. Desiaqn a set of functions for araphical 
immput and outout. 


3. Write a orogrammer's manual. 
4. Write the software, to verform the graphic 
functions. 
This approach was taken to insure the development of a user 
oriented araphics design rather than one that was merely 


easy to program and implement. 
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B. CONSIDERATIONS FOR A USER ORIENTED DESIGN 


One of the goals of this interactive subroutine library 
is to provide a general purpose high level package that wil] 
support a wide variety of applications. Additionally, it is 
important that the system be user oriented. This means that 
the resulting graphics orograms should be as easy to write 
and maintain as any other interactive orogram. The design 
has to provide a clear and vivid means of describing the 


pictures a user wants to create [15]. 


In trying to produce this type of user oriented package 
several requirements have to be met by the desian specifica= 


tions. 
bes Graphics Primitives 


A graphics system should crovide a smal] number of 
powerful graphics primitives [8]. These should be designed 
in such a way that the user 1S required to concentrate = on 
the picture being described rather than on the hardware 
features of the machine. The user must be able to construct 
logical picture segments, combine them into a meaningful 
picture and then manioulate any combination of these picture 


segments C13). 
Ce Default Parameters 


Default parameters should be skillfully introduced 
into the system [8]. This eliminates a novice user from the 


irritating details of the system. If default values are 
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automatically includeds a novice user can concentrate on the 


basic problem of describing a picture. 


3. Error Diaanostics 


User paramaters should be checked and aj} errors 
should provide informative diagnostics. Errors should only 
activate diagnostic routines, and they should never force 
the termination of auser program [10). A user should be 


able to trace and correct errors with a minimum of effort. 


2) 





Ve. VECTOR GENERAL USER INTERFACE DESIGN 


The design of the Vector General high level interface 
is implemented in the form of Subroutine library functions 
which are utilized through programs written in the high 
level language C. Every effort was made to limit the number 
of functions without limiting the hardware capabilities of 
the Vector General. The design of this primitive set is 
based on the concept of picture structure, as defined by the 


constructs picture, object and element. 


A. PICTURE STRUCTURE AND USER ASSOCIATION 


The present interface provides” the capability o f 
describina pictures as a collection of objects with associ= 
ated elements and attributes. The framework for this logi- 
cal description of a picture and the implementation of a 
Structured display file is orovided by the existing intere- 
face. This iSr however, inadequate because within this 
framework a user cannot easily qenerate the actual display 
instructions that make up each element. Additional capabil-=- 
ities for easily describing a logical picture element and 
its association with other elements and with the picture is 


Orovided by the design described here. 
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The implemented design introduces the concept of an ele=- 
ment Saale An element block consists of a series of move-= 
draw instructions or of ASCII character data. This approach 
provides a flexible way for clearly isolating and naming 
specific picture segments. Additionally the responsibility 
of dimensionina arrays for each element display list is 
removed from the user and is instead managed by the software 
interface. This dynamic allocation and management of display 
lists by the software interface greatly extends the flexic- 
bility of an element block. Each element block can contain 
not only graphic functions but any of the C-lanquage arith- 
metice conditional or logical statements, as well as 
Subroutine calls. A user can also define a graphical entity 


within an element block recursively. 


Many problem solutions are most aporopriately defined in 
recursive terms. Wirth sites several examples of graphic 
patterns that are most easily described by a recursive algqo- 
mrtnm (15). The caoability of defining elements by recur 
Sive algorithms provides the user with another powerful 


Gao! e 


In addition to the element block structuring,y a primic 
tive is provided so that the user can easily establish the 
desired elements, object relationshios. This provides”) an 
easy and concise method for loaically constructing a pice 
ture. With this primitive any number of element blocks can 
be associated with an object at one time or at several dif-= 


ferent times within a proaram. 
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B. SELECTING NON#=LIMITING PRIMITIVES 


The Vector General provides i2 different vector types, 
arcsre circles, ASCII characters and has the facilites for 
creating three dimensional images. Incorporating the flexi 
bility of ie vector types and two or three dimensions within 
a limited set of graphic functions presents several probe 
lems. The hardware capabilities of the Vector General must 
be available to a high level user in a concise and logical 
manner. Extending the function set to include separate funce 
tions for each vector type and for two or three dimensions, 
1S not appealing because it provides a user with too many 
opportunities for meaningless and erroneous operations [lied]. 
The other possibility 18 to use variable length parameter 
lists for a small function set. The C-lanaquage supports the 
use of varible enaen parameter lists and this approach 15 
implemented without compromisina other factors such as ease 
of use, simplicitys and understanding. This aporoach lead 
to the development of nine functions whichs in combination, 
allow utilization of al} of the Vector General facilities in 
creating an element block and establish the desired object, 
element linking. <A complete description of these functions 


can be found in Appendix A. 
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C. NAMING CONVENTION 


The constructs object, element and picture provide a 
multiwlevel naming structure [14]. This structure allows a 
user to associate integer names with each object and element 
that is created. These integer names are assigned values by 
the user interface. Additionally each element is also asso- 
ciated with an array name.e. This naming conventions which 
requires usersinterface interaction is inadequate for a high 
level interface. A naming convention that allows a user to 
independently assign meaninaful names to objects and elee- 
ments is required. The high level interface design 
described here orovides a Rene ie naming process”) which 
requires a euser to specify an element or object name as a 
quoted character string within a carameter list. A name is 
associated with each element and object as they are created 
by the user. There are no limitations imoosed on the user 
IN aSSIGNING Names exceot that each name must be unique. 
Each object and element name is used throughout the program 
to reference a specific picture segment. This implementa= 
tion provides a flexible and easy method for a user to asso- 


ciate meaningful names with each object and element. 


The existing interface supoorts the concept of shared 
display code, thus allowing for the repetition of an element 
iN a picture. This repetition is accomplished by associat 
ing an element with several objects or with one object 
several times. This latter case requires that a user be 


able to uniquely reference each occurrence of an element 
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within a specific object. Fhe naming convention had to be 
extended to handle this situation. A primitive has been 
designed that allows a user to assign any number of unique 
aliases to a specific element block. An element can be 
associated with an object several times, each association, 
however, is established by using an alias. In this way each 
occurrence of an element within a specific object can be 


uniquely referenced by its alias. 


D. ERROR DIAGNOSTICS 


All functions and user routines provide error checking 
and diagnostic information. An error will never cause the 
termination of the user's orogram. Every effort 1s made to 
allow auser's program to run to completions so a user wil] 
receive some visual feedback from the Vector General display 
screen. A picturer, even one that results from several 


errors can act as a useful debuaging aid in itself. 


PeeetiiGH LEVEL USER ROUTINES 


In order to provide a comprehensive graphics package, 
the naming convention and picture structure concept has to 
be applied to the lower level user routines that dynamically 
change and manipulate picture seqments. These routines are 
incorporated into this high level structure. When possible 
several low level routines are combined to provide the user 
with a simpler and yet more powerful routine. For example, 


separate routines for the deletion of an object and element 
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from the display screen are provided at the lower level. 
These two routines are combined into one routine that erases 
the entire picturer an objectrs, or any number of elements 
associated with a specific object. Addittonallys a routine 
is included so a user can not only erase an element block 
but also free up the memory locations associated with the 


element block. / 


The advantages of allowing a user to manipulate display 
list storage lies in the fact that it is extremely difficult 
for the software interface to determine which display list 
Structures are no longer required and should be removed. 
The user on the other hand knows crecisely when ae specific 
item 1S no longer needed [16). The system makes available a 
finite area for the creation of display lists. Erasinq an 
element does not release memory. Elements still exist and 
can be reassociated with the picture at anytime. The user 
should have the ability to optimize this storage area,r by 
releasing elements that are no longer required. This is 
particularly important when a user program exceeds the allo- 
cated display list storage. Only by selectively removing 
elements from memory and releasing the related memory loca- 
tions can new elements be created. A user can extend the 
systems storage limitations by efficiently managing the 


display list storage area. 
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VI. RECOMMENDATIONS 


The implemented graphics subroutine library provides a 
general purpose interactive graphics oackage. fhe routines 
provided for usina the external display control devices are 
adequate, but can be extended to provide a simpler package 
for a user. For examoler, the routines that control the 
function switches and the function switch lamps could be 
combined to provide a simpler interface. A varietv of 
routines for utilizing the light pen should be available to 
aouser. For example, a light pen trackina routine would bene 


ifit the system. 
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VII. CONCLUSION 


The high level general purpose oaraohics' subroutine 
library discussed in this thesis 18 operational. Initial 
test programs indicate that the system does provide ae sim= 
ole, but powerful approach for the development of interace- 


tive graphics proorams. 
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APPENDIX As: USER REFERENCE MANUAL 


I. INTRODUCTION 


The vector general is an interactive graphics) display 
System which has been interfaced with the PDP=-11/50 comput- 
er. The display interacts with a POP=-11 user by displaying 
pictorial information on the Surface of a cathode ray tube 
and by accepting information from its external control deve 
ices. The external devices consist of an alphanumeric key= 
board, 32 lighted function switches, 10 control dialssr and a 
light pen. Through a Cecallable interactive graphics program 
libraryr the pictorial information desired by a user Can be 
Gescribed, altered and manipulated. This manual wil? not 
discuss in detail the electronic functions of the vector 
general, or the vector general's interface with the PDP-11. 
The purpose of this manual is to instruct a user in the 
creation and manipulation of pictorial data on the vector 
general display. 

This manual describes the use of a Cecallable interac- 
tive graphics orogram Ilibrary.e A knowledge of the Ce 
programming language is assumed. The user is also directed 
to Appendix 8B for a brief descriptions, calling format = and 
error diagonistic information on each of the user interface 


routines. 
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PieetGrevectiOr GENERAL DISPLAY SYSTEM 


A more detailed discussion of the vector aeneral can be 
found in the Users Manual for the Vector General Display 
Unit [6] and the Desian Manual for the Vector General 


Display Unit [5S]. 


A. THE DISPLAY 


The vector general is a cathode ray tube (CRT) display 
on which a visible ecattern can be created by the movement of 
an electron beam. The electron beam causes a florescent 
soot to appear on the face of the display tube. The move- 
ment of the beam is controlled by a method called random 
scanr which in effect steers the soot in ae Sstratiaht line 
between two points on the disolay screen. The resulting 
line or vectors, combined with others, creates a odDicture or 
pattern on the display screen. 

To maintain a clear picture on the display screen re- 
Quires that the pattern be redrawn on the tube repeatedly at 
approximately thirty to forty times a second. Each repeti- 
tion is called a frame and the frequency at which it 1s 
redrawn is called the refresh rate. If the pattern is not 
repeated often enoughs, or more information than can be 
redrawn in a frame is disolayed, a distortion of the picture 
will occur on the display screen. This distortion is called 


flicker. 
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B. WARDWARE FEATURES 


The system has several hardware features, in addition to 
@ vector generator, which greatly extends its capabilites. 
These include, the ability to produce three dimensional fig- 
ures, an ASCII character setr and the hardware generation of 
arcs and circles. Other features provide the hardware 
mechanisms for the rotation and translation of user speci- 
fied picture seqments. These hardware features are con- 
trolled and coordinated by the display controller. The con- 
troller is responsible for handling the communications 
between the user interface, the external control devices and 
the display hardware. 

The main ‘purpose of the external control devices is to 
facilitate user interaction with the display. These devices 
include an alphanumeric keyboard, 32 0—Clodlighted~== function 
Switchesr 10 control dials anda light pen. 

Additional information on the vector general hardware 
can be found in the Graphics Display Reference Manual (1) 


and the Graphics Display System Technical Manual [3]. 


C. THE SYSTEM INTERFACE 


A vector general user defines pictorial data and its 
manipulation within a C-language program. The execution of 
the program, on the PDP-11/50, causes the vector genera) 


software interface to be activated. [t 1s this software 
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interface package, which communicates user requests and 
receives information from the vector general controller. The 
interface package passes user requests, in the proper form, 
to the diplay controller. The controller will activate the 
proper generator (Cie. character, vector, are/circle) which 
will output the desired information, requested by the user, 
on the diolay screen. The controller will also oass infor- 
mation from the external control devices back to the user 
via the interface software. This relationship is illustrated 


in fiaure A-l, 
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D. INTERFACE WITH EXTERNAL DEVICES 


Each of the the external tnteractive devices communicate 
directly to the vector general controller. Information from 
these devices is returned to the user via the controller and 
the user interface.’ The user program may utilize the infor- 
mation returned from these devices to control! program flow. 
This allows a user to interactively control and manipulate 
the pictorial information at display time. Specific user 
routines which activate these external devices and provide a 
communications channel with the user are discussed in detail 
in later sections of this manual. 

1. Alphanumeric Keyboard 

The alphanumeric keyboard allows the user to input 
information in the form of ASCII character codes. Through 
Beme user interface the user can disslay the information on 
the vector general display screen. The data entered from 
the keyboard can also be returned to the user program (for 
processinge 

2. Function Switches 

The 32 lighted’ function switches provide the user 
with information which can be used to interactively manipu= 
late pictorial data at disolay time. Each function switch 
can be assiaqned specific meanina by the user program. The 
user interface returns, from the controller to the user, 
information on which function switches have been pressed. A 
user program could use this information to selectively 
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rotater, translate or perhaps scale particular picture seg- 
MeNts. 
3. Control Dials 
The 10 control dials provide numeric information to 
the display controllers specifying the degree to which each 
dial has been turned. This informations through the user 
interface, can be provided to the user. A user orogram may 
utilize the values of the variable control dials in detere- 
mining the distance or rate at which a oortion of the pice 
ture may be moved or rotated. 
G4. Light Pen 
The light pens a wand containing a photo celle can 
be used to selectively point to different picture segments 
on the disolay screen. The interface provides a user proe 
gram with information on which picture seqment was pointed 
to by the liaht open. A user program can turn the liaht oen 
selectability of soecific picture segments on or off. For 
example, an interactive user miaht select sections of a pic 


ture for erasure by pointina to them with the light pen. 


IIIf. INTTIALIZATION 


A. INTERFACE INITIALIZATION 


The vector general disolay system and the interface 
software with the PDP-11 must be initialized before any data 
can be displayed. The initialization routine sysinit must 
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be called before any other routines are utilized. Tas 
routine sets all the system default parameters, such as the 
screen coordinate system. 

If for some reason the initialization cannot be complete 
ed the user program will be terminated. This error usually 


occurs because another user 158 accessing the vector general. 


Be. DISPLAY INITIALIZATION 


1. Coordinate System 
The user can specify @&@ two or three dimensional 
cartesian coordinate system, of any scale. All display coore- 
dinate values referenced by the user will be interpreted 
according to this coordinate system definition. A user may 
redefine the coordinate scale at any time in a program. The 
user will define the coordinate system in acalli to the 


routine coordsys-. 


coordsysl(dimreminxsmaxxesminyrsmaxy ([Ceminz,maxz2z])] ); 


The routine requires the user to specify if the coordi- 
nate system is to be two or three dimensional and the range 
of each coordinate. If the parameter dim is twor, iIndicatina 
a two dimensional coordinate system is desired, the ranae of 
the z coordinate can be omitted, and will be ignored if it 
should be included. 

If this routine is not called by the user the default 
coordinate system will be used. This default system is 
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defined as three dimensional with the xr yr 2 coordinates 
ranging from “100.0 to 100.0. All coordinate values wil! be 
interpreted by this default system when coordsys is not 
called by the user. 

2. Picture Scale 

The rectangular, 13 by 14 inchs portion of the 
display screen that can be viewed by the user is called the 
visible space. The maximum picture soace is larger than the 
visible soacer covering an area of 30 by 30 inches. This 
extra area allows a user to rotate or move part of the pic= 
ture to the extreme boundries of the visible space without 
any distortion. It also permits limited zooming. 

The pictorial data being displayed can be adjusted in 
sizer, or scaledr by two different controls. Oner the gain 
control dials on the vector general display unit allow the 
user to manually manivulate the picture scale. The second 
provides scale control within the user's program by callina 
the routine vapscal. This routine is discussed in detail in 


Section V of this manual. 


IV. CREATING A PICTURE 


eee fT LCTURE STRUCTURE 


All of the information that a user desires to display on 


the vector qeneral must be incorporated into the 
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hierarchical picture structure defined by the user interface 
package. The three hierarchical levels are defined as: pica 
turer, object, element. These levels specify the underlying 
structure of the araphical display and determine the operas 
tions a user can perform on information associated with 
each level. 

The term picture refers to all of the data that is to be 
displayed on the vector genera] display space. The term 
element refers to the smallest picture segment which can be 
independently referenced and changed without affecting the 
remainder of the oicture. Each elements, or indenendent pice 
ture segment, has a unique name associated with ite A cole 
lections, or meaningfull groupings, of elements 15 called an 
object. Each object is also labeled by a unique name so it 
can be easily referenced by a user. Figure A-2e illustrates 
the relationship of the three levels in the actual structure 
of a oicture. 

An element is completly described and named by the user. 
It can describe either graphical or ASCII character data. 
An element can be independently added or erased from the 
display screen. It can be caused to blink or be specified 
as being light oen selectable. 

Each element must be associated with at least one object 
before it can be displayed on the vector general. An object 
can consist of one or more elements. A user 1s reponsibdle 


for establishing the desired objectrelement association, 


by 
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and for specifying a unique name for each object. Each user 
defined object can be independently rotated, or translated 
to any section of the 30 by 30 inch display space. An ob- 
ject can be added or erased from a picture, scaleds and 
specified to blink or to be light pen selectable. Each 
object's intensity can be varied in order to give three 
dimensional objects their depth queuing. These actions, when 
applied to a specific object, affect every element that has 
been associated with it by the user. 

A picture can contain one or more objects. The coordi-= 
nate scale and picture scale defined by the user affects the 
entire picture. A picture's coordinate scale can be varied 
but this action will affect every object defined as part of 
the picture. An entire picture can also be erased, speci-= 
fied to blink or be light pen selectable. 

A summary of the operations for each level of the 


hierarchy is outlined in Figure A-w-3. 


B. CONSTRUCTING AN ELEMENT 


Every element is comoletely described by the user within 
an element block. There are two types of element blocks. A 
draw element block, describes graphical information. The 
other, a character element, describes ASCII characters that 
are to be oy Sia Nene. Each element is uniquely named and 
this name will be used to reference this particular struc- 
ture. 
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1. Oraw Element Block 

A draw element block represents a group of draw 
instructions that describe a specific structure, or picture 
segment. These draw instructions include setvector, move, 
line, are and circle. A draw element block beains with a 
call to the routine drawele and 1s terminated by a call to 
the routine endele. The draw instructions that are executed 
between drawele and endele describe the actual picture seg= 
ment . 

The only parameter required by drawele is a quoted chare 
acter strings, or pointer to a character strings, specifyinoa 
the name the user wants to associate with this element. 
This name will be used throughout the proaqram to reference 
this element block. 

The basic draw element block, and the related draw in- 


structions are reoresented in the following format: 


drawele("elementename"); 
setvector(vtynersvmode, [inc], (scale] ); 
=--setvector(vtype,vmode, linc], scale] ); 
move(x, [yl], €z])3 
line(x, (v)},(2)); 
circle(dir,centx, {centy), (centz) ); 
== arcl(dir,centx, [centy] , (centz)] ,endx,s, lendy] » lendz) ); 


endele(); 


The user can select one or more of the twelve vector 
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types in constructing an element. These vector types 
describe how the coordinate data will be interoreted in 
drawing a vector on the display screen. The choice of a vec= 
tor effects the parameters that will be passed in each of 
the mover lines circle or are instructions. The user speci 
fies a vector selection by callina the routine setvector. 

@. setvector - This draw instruction must be called 
immediately after draweles and may be called any number of 
times within the element block. Each setvectors, and the draw 
instructions that follow its comorise a subgroup. fhe set- 
vector instruction determines the manner in which the line, 
mover arc and circle instructions in the subgroup will be 
interpreted, as well as their visual appearance on the 
display screen. The routine is called with the following 


parameters: 


setvector(vtyoe,vmode [zinc] [rscale] ); 


The parameter vtynoe specifies which one of the twelve 
vector types the user wants the following group of line, 
mover, arc and circle instructions to utilize. The parameter 
vmode indicates the vector modes, or appearance of the vec- 
tors to be drawn (ies, solid liner dotted lines, etc.). Cer- 
tain vector types require additional information, this ino- 


formation is specified by the parameters inc and scale. 
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NAME 


VAX 


VAY 


VAZ 


VR 


VRX 


VRY 


VRZ 


JABCE SR =] 


SUMARY OF VECTOR TYPES 


DESCRIPTION 


vector absolute, each coordinate is specified 
with respect to the origine Each point(xsy,2) 
references a unique point on the display screen. 


vector absolute autowrtncrement x, every draw 
instruction causes the y and 2 absolute 
values to be updated while x is stenped by a 
constant value. 


vector absolute autorincrement yr, every draw 
instruction causes the x and 2z absolute 
values to be updated while y is stepped by a 
constant value. 


vector absolute autorincrement 2, every draw 
instruction causes the x and y absolute 
values to be updated while 2 18 stepped by a 
constant value. 


vector relatives, each xr yr 2 coordinate 

value indicates the amount that 18 to be 

added or subtracted from the previous absolute 
coordinate point. 


vector relative autosrincrement x, each draw 
instruction causes the y and Zz coordinate values 
to be incremented by the specified value while 

x 18 Stepped by a constant value. 


vector relative autowincrement y, each draw 
instruction causes the x and 2 coordinate values 
to be incremented by the specified value while 

y 18 stepped by a constant value. 


vector relative autorincrement 2, each draw 
instruction causes the x and y coordinate values 
to be incremented by the specified value while 

z 1S stepped by a constant value. 
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INCe= 


INCX= 


INCY= 


INC3- 


TABLE AeT 
(continued) 


two dimensional incremental vectors a 
relative vector that optimizes storage re= 
Quirements. The coordinate increment values 
are limited to values approximately 3% of the 
user's coordinate ranae. 


two dimensional incremental autowincrement x~, 
is a relative vector that optimizes storage 
requirements. The y coordinate value is 
incremented by a small value while 

x 18 Stepped by a Constant value. 


two dimensional incremental autostincrement y-, 
is a relative vector that onotimizes storage 
requirements. The x coordinate value is 
incremented by a small value while 

y 18 Stepoed by a constant value. 


three dimensional incremental vectors a 

relative vector that optimizes storage re= 
Quirements. The xs yr 2 Coordinate increment values 
are limited to values that are approximately 3% 

of the user's coordinate range. 
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A brief summary of the twelve vector types 1s listed in 
Table Aw-I, a more detailed account of each vector type and 
the parameters required by setvector are listed in Aopendix 
B. Figure A-4 illustrates Sho whe different vector modes 


that are available. 
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FIGURE A-#-4 


oe move = The draw instruction move 1s used to 
reposition the beam on the display screen. It will produce 
fomevisiole line or pattern. The format of the instruction 


1S: 
move (x (ry) {,2)); 


The coordinate values x, yr 2 will be either absolute or 
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relative values. The vector type selected in the proceed= 
ing setvector instruction wil! determine how the value of 
these parameters will be interpreted. The bracketed values 
indicate parameters that may be ootional. 

If the user coordinate system is not three dimensional, 
the z parameter can be omitteas, ang will be ignorea if it 
Srould te irclucec. 

ce. line = The lire instructions, draws a visible 
line or vector on the display screen. The line is drawn 
from the present beam locaton to the specified end point. 


The format of the instruction is: 
line(€x (-y]) l-2)); 


The coordinate values xr yr 2 will be either absolute or 
relative values. The vector tyne selected in the previous” 
setvector determines how the value of these parameters will 
be interoreted. 

If the user has defined a two dimensional coordinate 
System, the Zz parameter can be omitted, and wil! be ignored 
if it should be included. 

d. circle = The circle instruction will draw a cir=- 
cle beginning at the present beam location about the center 
point specified by the user. The difference between the 
present beam location and the center point determines the 
radius of the circle. The instruction is used by the _ fol- 


lowing format: 
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circle(dir,centx (€,centy)] (,centz)]); 


The parameter dir indicates in which direction the cir- 
cle is to be drawn, clockwise or counterclockwise. The 
number of parameters required and their values are deter= 
mined by the vector type selected in the previous setvector 
instruction. A circle cannot be drawn by any of the four 
imcremental vectors. 

If the user coordinate system is two dimensional, the 2z 
parameter can be omitted, and will be ignored if included. 

Ce. arc = The arc instruction will draw an arc from 
the present beam location, about the specified center point, 
to the desired end point. The distance between the starting 
point and the center point determines the radius of the arc 


being drawn. The instruction format is 3 


a 


arc(dir,centx [,centy] [-centz],endx l,endy] [(,endz]);3 


The parameter dir, gives the direction the arc is to be 
drawn, clockwise or counterclockwise. The coordinate values 
are determined by the vector type selected in the previous 
call to setvector. An arc cannot be drawn by any of the four 
incremental vectors. 

If the user coordinate system has been defined as two 
dimensional, the 2 parameters can be omitted, and will be 
ignored if included. 

If the distance from the starting point of the arc to 
the center point, and the distance from the end point to the 
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center point are not equal, the resulting arc will contain a 
straight line. The straight line results from the arc gen- 
erator trying to compensate for the two different distances 
to the center point. One distance will be used to determine 
the radius of the arc, the arc will then be drawn using this 
radiuse fhe arc will stop at the systems new defined end 
point and ae straight line will be drawn to the end point 
that had been specified by the user. The resulting arc ap-= 


pears in the following forms: 


e. Character Element 

A character element represents ASCII character data that 
1$ to be Incorporated into the picture structure. A user can 
specify a character element containina ASCII, special vector 
general characters and formatting symbols to he eral awk on 
the vector aeneral display screen. A user can select from 
four character sizes and has the option of selecting a 
slanted character set. The text can be displayed horizon=- 
tally or vertically on the screen. The vertical position 
causes the characters to appear as 1f they were on a page 
that had been rotated ninety dearees counter clockwise. The 
user can select the position on the screen where the string 


1$ to begins or can output it relative to the present beam 
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position. 

Each character element is given a unique name by the 
usere This name will allow the user to easily reference 
each character element. A character element iS represented 


by the following formats: 


charele("*element-name",stringsSizerswdir,Slant,xry)>, 


The parameter string can be either a quoted string 
within the parameter list or a pointer to a character string 
or array. The character string will begin at the point(x,y) 
or can be output relative to the present beam location by 
replacing the x and y parameter with the constant VGREL. 
For example, the following character elements, when linked to 
an objectr would be outout relative to the present beam 


position: 


charele("“elemente=name","Now is the time",SZ4,HOR,SLNIT,VGREL); 


A summary of the character element oarameters 1S 
presented in Table A-II. The character set available on the 
vector general is illustrated in Figure A#5. All of the vec= 
tor general characters can be represented within a character 
String. The special formatting symbols and svmbols for the 
special vector qeneral characters are listed in a Anpendix 


B. 
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TABLE A-TI 


SUMMARY OF CHARACTER ELEMENT PARAMETERS 


size: specify character size 


SZ / 00 - use previously defined character size 
S$SZ1 / 0100 = set size to 100 columns by 60 lines 
SZ2 / 0120 - set size to 81 columns by 41 lines 
SZ3 7 0140 <= set size to 60 columns by 30 lines 


SZ4 / 0160 = set size to 32 columns by 16 lines 


wadirs write direction 


HOR / O00 - write characters horizontally 


VER 7 0200 = write characters vertically 


slant: specifies reqular or slanted characters 


SLNT / 00 - slanted characters 


NSLNT/ 01 - regular characters 
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Character Set 


FIGURE Ae#5 
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meee LINKING ELEMENTS 16 OBJECTS 


Draw and character elements represent the smallest pic- 
ture segment that can be independently referenced by the 
user. In order to display an element it must be re ee 
with at least one object. An object represents the smallest 


entity that can be displayed independently on the vector 


general screen. 


1. Object Routine 

Each object is given a unique name so it aan be 
easily referenced by the user. Elements can be linked to an 
object at one time or by several different calls to the 
routine called object. An object can consist of one or more 
elements. A soecific element can be linked to several dif- 
ferent objectsS,s or may be linked to one obdject' several 
times. This objectrelement association or Jinking 1s esta 
blished by the routine object. This routine has the follows: 


ina format: 


object (num,"objectename","element=name",.2er*elementename"); 


The parameter num indicates the number of elements that 
are to be linked to the named object by this call. The ele- 
ments are referenced by the names specified, by the user, in 
the preceding drawele and charele routines. Since each obd- 


ject is associated with a unique name, a second cal! to 


Sie 





object, with a duplicated object once will cause the ele- 
ments to be added to the object first associated with that 
name. 

When an element is linked to a specific object several 
times, the user can no longer reference a specific oc- 


currence of this element within the objects for example: 


object (3,"Tree","*branch"s"branch","branch"); 


In this case the element branch has been linked to the 
object tree three times. When displayeds, element branch 
will appear three times. Now ,however, the user cannot 
uniquely reference a specific occurrence of the element 
branch. If the element called branch was selected to be 
erased, the first occurrence of branch would be erased from 
the screen. In many instances it may desirable to uniquely 
reference each occurrence of an element within a specific 
object. This can be accomplished by associating several] 
unique names with an element. The routine copyele provides 
this capability. 

c. Copyele Routine 

This routine allows a user to assign several unique 
names to a specific element structure. In this way,r an ele- 
ment structure can be associated with an object several 
mimes! and Gach occurrence can be uniquely referenced. The 


routine 31S represented by the following formats: 
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copyele(num,”"elementename","copyl=name","copydcé=name",...)3 


The parameter num indicates the number of additional names a 
user wishes to associate with the named element structure. 
The “element=name" refers to a previously defined draw ele- 
ment or character element block. Each of the "copy=names" 
must be unique. | 

Now reconsider the previous example. If the element 
branch is associated with two other unique names and these 
three names are used in the objectrelement linking, each 
occurrence of the structure can now be uniquely referenced 
by the user. The following two statements will accomolish 


this task. 


copyele(2,"“branch","branchl"-"“branche"); 


object (3,"tree","branch","branchl","branche"); 
V. DISPLAY MANIPULATIONS 


A, USER ROUTINES 


After the user has incorporated all data that is to be 
displayed into the desired picture structure, it can now be 
manipulated and transformed. The following user routines 
provide the means to manijioulate the picture, objects and 


elements that have been created by the user. 


54 





A description of each user routine, calling format and 


error diagnostics are included in Appendix 8. 


be «6B Think 
The display blink mode can be set for the entire 
picture, single object or for any number of elements associ- 
ated with a specific object. Modifying the blink mode of = an 
object affects al! the elements associated with that object. 
The routine blink will turn the blink mode on or off for the 
specified picture segment. 
2. Erase 
The entire picture, a single object or any number of 
elements associated with a specific object can be erased 
from the display screen. The picture segments that are 
erased from the screen can be redisolaved by again estab- 
lishing the desired objectrelement association. Fhis 15 
accomplished by calling the routine object, as described 
earlier. Erasing an object will) affect all elements associ- 
ated with the named object. 
3. Input Data from the Display Keyboard 
The routine indata allows a user to receive and out- 
put characters from the vector general keyboard onto the 
display screen. The ASCII character data is also placed in 
a user specified character array for processing by the 
user's program. Up to one line of text can be entered, data 
entry 1S terminated by a carriage return. The termination 
of the data entry also erases the output characters from the 


Sr. 


display screen. 
G4. Intensity Offset 
The routine intoffset allows the user to vary the 
intensity level of a three dimensional objects or impose a 
screen cutctoff plane for the named object. 
Se Intensity Scale 
The routine intscale allows a user to vary the ine 
tensity of a three dimensional object, this provides”) the 
depth-cueing or shading for a three dimensional object. 
6. Light Pen 
The light pen selectability of the picture, a single 
object, or any number of elements associated with a specific 
object can be turned on or off by the routine called 
lghtpen. This determines what picture segments will be 
affected by light pen interactions. 
7. Remove 
The routine remove provides a user with the ability 
to release the memory locations associated with a specific 
element structure. The user can remove the picture and 
release all the memory locations that have been used to 
describe all the existina elements. Additionally the picture 
will be erased from the screen. Each element that is removed 
from memory can no longer be referenced or linked to ob- 
jects. An individual element can also be removed from 
memoryr, this will cause every occurrence of the element to 


be erased from the screen and the memory locations 
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associated with the element's description will be released. 
The user can specify an element for removal by either it's 
original mame or by any of the copy names associated with 
it. Remove results in the elimination of all occurrences and 
all copies of an element from the display screen. A element 
that has been removed can be redisplayed only by recon= 
structing the element block and by again establishing the 
desired ohbjectrelement association. 
8. Rotate 
This routine allows a user to rotate an object about 
the xr yr, and z axis. The rotation of an object affects al] 
elements associated with the named object. Arcs, circles 
and characters are always drawn in a plane fcarallel to the 
Screen, and are rotatable in a three dimensional coordinate 
system about the z-axis. 
9. Scale 
The routine scale allows a user to scale indepen- 
dently any object of the picture. All elements associated 
with the object will be scaled by the specified scale fac- 
tore 
10. Translate 
The routine trans allows the user to move an object 
anywhere in the disclay space. The object and all its asso- 
ciated elements can be noved in the xs yr and z plane. Cone 
tinually translating an object by very small] increments wil] 


cause it to appear as if it 18 moving across the display 
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screen. The following example will move the named object 
diagonally across the display screen: 


x = y = .01 S/ecoordinate system is 2D 
//ranaging from -l1 to 1. 
for(i=0741<1007 i++) 
{ trans "box", xs y)? 
x weet. OL 
y Voutos0 1; 


} 


VI. OTHER USER INTERFACE ROUTINES 


Additional user routines are available and are described 
in detail in the Users Manual for the Vector General Display 
Unit (ot... Only a brief summary of each routine will] be 
presented in this manual. 

L vgclock 

This routine allows a user to set the refresh rate 
of the vector general display. The vector general is au- 
tomatically initialized with a refresh rate of forty hertz. 

Ce vadial 

The routine vadial returns pet tive user's program the 
values of the ten variable control dials. 

3. vggetcar 

The routine vagaetcar will return to the user's pro- 
gram a single character entered at the vector general key= 
board. If no character has been entered a -1 will be re- 
turned. This routine does not display the characters on the 


vector general display screen. 
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a; vagetfsw 
This routine will return to a user's program the 
value of the 32 function switches. The values returned will 
indicate which function switches are depressed. | 
5. valamos 
This routine is used in conjunction with vgaetfsw. 
It will turn on the function switch lamp for each function 
Switch that is depressed. 
o- vapicture 
This routine causes the user's picture to. be 
disolayed on the vector aeneral display screen. Nothing 
will appear on the display screen until this routine is 
called. 
7. vqpost 
The routine vapost allows the user to transform the 
pictures coordinate axis. This transformation will cause 
the entire picture to be repositioned on the display screen. 
8. vapscal 
The user can modify the scale of the entire picture 
by calling the routine vaoscal. 
9. vaterm 
This routine terminates the vector general process 
and releases all the systems resources that were being util= 
1zed by the vector general. This routine should be called 


at the conclusion of all vector general display onoerations. 
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VII. RUNNING A VECTOR GENERAL PROGRAM 


A. PROGRAM FORMAT 


In order to properly utilize the vector general display 
system, routines to initialize and terminate the system must 
be pened These routines initialize the vector general, 
Start the actual visual display and properly terminate the 
display at the end of a users proaram. Each user program 
must include a call to these three routines? 

sysinit(); 
vagpicture(); 
voterm(),; 

The first routines, sysinits must be called by the user 
before any other user interface routine is called. To 
display the picture that a user has described on the vector 
general screen, the routine vgpicture must be called. This 
routine is called only once, and nothing will aopear on the 
screen until it has been called. Finallyr to properly ter- 
minate, the system requires a call to the routine vaterm. at 


the end of the user programe 
eae 'O COMPILE 


Once a graphics program for the vector general has been 
writted in the Celanguaae it must be compiled with the user 
interface graphics subroutine library. To include this ine 


formation auser should issue the following command to 


60 





properly compile a vector general graphics program: 
cc =O filename =lv 


In order to utilize the vector general's program constants 
used in this manual, the file containing these constants 
must be included in each graphics program. The following 


command will inelude the files 


Rinclude "/usr/lib/vaconeh" 
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C. SAMPLE PROGRAM 


The following is an example of a C-lanquage vector gen- 
eral graphics program. The actual oicture produced by this 
program is illustrated in Figure A-6. 

Hinclude "/usr/lib/vgcon.h” 


main() 
{ 
int i- 
sysinit(); //initailize the vector general 


//define coordinate system 
coordsys(2,271.0,1.0,71.-0,1.0)3 


drawele("box"); 
setvector(VA,LN); 
move(eWi, ee 0); 
line( 1.0, 20); 
line( 1.0, 1.0)?3 
line(-1.0, sos 
line(-1.0,° ae 0); 
endele(); 


charele("name","%I BOX",SZ4,HOR,NSLNT,VGREL); 


drawele("ziazaq"); 
setvector(VA4A,LN),; 
move(-0.5,70.5) 
setvector(INCX,LN,.0308,NMG); 
move(.0308,.0308)3 
for(i=z=0 5; i< 7 gg G+ ) 
line(.0308,.0308)>; 
endele(); 


J//establish objectrelement relationship 
object (3,"bigbox","box","name","zigzag"); 
object (3,"smallbox","hox","name","ziQgzaq"); 


scale("biqbox",0.5); 
trans("bigbox",-0.5,70.5);3 
scale("smallbox",0.25); 
trans("smallbox",0.5,0.5)3 


vgpicture(); //disolay picture 
sleen(30)3 //display picture for 30 sec 
vaoterm(); //terminate vector qeneral orocess 
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[30% 


Picture Disolayed by Sample Proaram 


FIGURE A=-6 
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D. ERROR DIAGNOSTICS 


All error messaaes will] be printed on the PDP=11 termic 
nal screen during the execution of a vector general graphics 
programe The error message wil! identify the routine that 
was executing when the error occurred and the error. The 
errors will be identified by a number. A user can identify 
the Bob len by referring to the listing of errors in this 
manual or by referencing the specific routine in Appendix 6B. 
Most errors will usually result in the termination of the 
routine being executed with control being returned to the 
user program. Every ee ct will be made to execute the proe- 
gram to comoletion, so at least some of the users data will 
be displayed on the vector general disolay screen. A 


description of each possible error is listed in fableelIII. 
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TABLE=III 
ERROR DIAGNOSTICS 


Routine Error Numbers: 


arc 
blink 
charele 
circle 
coordsys 
copyele 
drawele 
endele 
erase 
indata 
intoffset 


1 intscale le 
2 Ightpen 13 
3 remove 17 
| move 15 
5 object 16 
6 remove 17 
7 rotate 18 
8 scale 19 
9 setvector ra) 
10 sysinit ei 
11 trans ee 


Error Diagnostics: 


EQ] 


E0e 


E05 


E04 


EOS 


E06 


E07 


Element block error. The specified routine 

has been called outside of a drawele block. The 
instruction will be tanored and control will be 
returned to the user's program. 


Space allocated by the system for the buildina 

of elements has been exceeded. See the routine 
remove in order to free up unecessary element 
memory locations. The instruction executing when 
this error occurs will be tqnored and control will 
be returned to the user's proaram. 


The value of the parameter dir was not C or 
Ce, The routine will be ignored and no are or 
circle will be drawn on the display. 


A character symbol included in an ASCII 

character string is undefined. The symbol will be 
ignored and control will be returned to the user's 
proaram. 


The named object does not exist, it has not 
been defined in a call to the routine object. 


The named element does not exist, it has not 
been defined in a call to either drawele or 
charele. 


An element name has been duolicated in a 

drawele or charele call. Each element structure 
created by drawele or charele must have a unique 
name. 
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EQ8 


E09 


Ell 


E14 


E15 


E16 


el? 


E18 


E19 


E20 


The total number of elements allowed 
by the system has been exceeded. 


The number of objects allowed by the 
System has been exceeded. 


The value of the parameter dim, 
specifying the desired number of dimensions for 
the user coordinate system is not aeor 3. 


The specified increment value falls outside 

of the defined coordinate system, the value will 
be  i1qnored and contro! will be returned to the 
user's proaram. 


The x coordinate values, or the x tncrement 

value falls outside of the user's defined coordi- 
nate system. The instruction executing at the 
time of the error wil! be iqnored and the move, 
line, arc or circle requested will not be drawn on 
the display screen. 


The y coordinate value, or the y increment 

value falls outside of the user's defined coordi- 
nate system. The instruction executing at the 
time of the error will be taqnored and the move, 
line, arc or circle requested will not be drawn on 
the display screen. 


The z coordinate value, or the z increment 

value falls outside of the user's defined coordi- 
nate system. The instruction executing at the 
time of the error wil! be iaqnored and the move, 
liner arc or circle requested will not be drawn on 
the display screen. 


The value of the oarameter num, 
soecifying the number of elements being OCassed in 
this routine is not between 1 and 10. 


A circle or are cannot be drawn by an 
incremental vector. 


The lenath of the user buffer specified 

for the routine indata is too small. The amount 
of data input from the keyboard exceeded the 
buffer size, characters received after the buffer 
boundry will be taqnored. 


66 





Eel 


~ 


A named element within a carameter jist 

is not associated with the specified object. The 
element was not linked to the named object tn a 
call to the routine object. The routine executing 
at the time of this will stop and return contro) 
to the user's proaram. 
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APPENDIX E: USER INTERFACE ROUTINE DESCRIPTIONS 


The description of the user interface routines aopear 
in the same format as the routine descriptions in the UNIX 
Reference Manual at the Naval Postgraduate Schoo! Computer 


Laboratory. 
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arc are 


NAME $s 


arc * draw an arc 


SYNOPSIS: 
arc(dir,centx l[,centy)] (€s,centz]),endx [r,endy) [,endz]); 


dir: CC / 004 = counter clockwise 
C / 010 = clockwise 


float centx [(r,centy] [,centz}),endx [rendy]) [rendz]) ; 


DESCRIPTIONS 


An arc is drawn from the present beam locations, about 
the designated center point, to the user specified end 
point. If the center point iS not an equal distance 
from the starting point of the arc and the end point, 
an arc will be drawn usina one of the distances as the 
radius. The result, is a straight line drawn from the 
actual terminatina point of the arc to the user specie 
fied end point. 


The parameters oassed for the center point and end 
point of the arc are either relative or abtsolute 
values. The number and value of these parameters are 
determined by the vector type selected in the previous 
call to setvector. 


Arcs cannot be drawn by any of the four incremental 
vectors. 


The 2 parameters are required only when the coordinate 
system 1s defined as three dimensionals and will] be 
ignored if inctuded when ec dimensional is specified. 


DIAGNOSTICS: 


All error messaaes will be printed on the PDP-il tere 
minal screen. 


Error = E01 


This routine has been called outside 

of a draw element block. 

The space allocated for the building 

of elements has been exceeded. 

Error = E03 = The draw direction was not defined 
as either C or CC. 

Error *- E15 = The x value was out of bounds. 


E02 


Error 


a) 





arc 
Error 
Erhor 
Enron 
ALSO SEE: 


setvector 


ane 


E16 ©- The y value was out of bounds. 

E17 =- The z value was out of bounds. 

E19 ©- [llegal arc/circle instruction 
from an incremental vector. 


Gives parameter requirements for each 
vector type. 
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blink blink 


NAME: 
blink = blink the entire picture or the specified 
object or elements 
SYNOPSIS: 
actions: 
ON / 01 = blink 
OFF / 00 = stop blinking action 
Parameter values: 
PIC / 00 
OBJ / -1 
To blink the entire pictures: 
blinkCaction,PIC); 
To blink a specific object: 
blinkCaction,OBJ,"“objname"); 
To blink elements of a specific object: 
blinklactions,num,"objname","elel",elec "seed: 
Int Num; 
DESCRIPTION: 
The blink mode for the entire picture, a single ob- 
ject or any number of elements of a snecific object, 
can be turned on or off. 
Modifying the blink mode of an object affects al] ele 
ments linked to that object. 
Num specifies the number of element names being passed 
in this routine, num can vary between 1 and 10. 
DIAGNOSTICS: 


All errors will be printed on the PCP -11 terminal 
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blink blink 


SGreeing SS 


Error = E0S = Unknown object name. 
Error = E06 = Unknown element name. 
Error = E18 = Value num not between 1-10. 
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charele charele 


NAME: 


charele = displays an ASCII character string 
on the Vector Genera] 


SYNOPSIS: 
charele("elename",charptrssizerwdirr,slants xpos, ypos); 
float xpos, yros, 


size: 

00 = use previous character size 
0100 © set stze to 190 col. hy 69 lines 
0120 = set size to 81 col. by 41 lines 
0140 = set size to 60 col. by 30 lines 
0160 = set size to 32 cole by 16 lines 


nm 
N 
Nm 
~ ~! NS SN. 


HOR / 00 = write characters horizontally 
VER / 0200 = write characters vertically 


slant: 
SLNT / 00 |= slant characters 
NSLNT 7 01 * do not slant characters 


xpOSss 
VGREL= to output characters relative to the 
oresent beam position the parameter xnoos 
should be replaced with VGREL and 
parameter ypos should be omitted. 


DEOCRIPTION: 


This routine displays’ the ASCII character string, 
specified by charptrs, on the vector general screen. 
The characters can be output by soecifying the desired 
coordinate starting point (xpos,yoos) or by outputing 
the string relative to the present beam location. The 
symbols available include formatting symbo]S and an 
extended character set. These can be included in any 
character strina by including the proper identifying 
symbols. The character string formattina symbols are: 
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charele . charele 


KEYBOARD FORMAT 
SYMBOL 
a backspace,moves back one character space 
ZA line feeds, oosition center screen 
4B line feed 
AL position at toprcenter of screen 
%D position at too,left corner of screen 
AE carriage control, line feed 
Jars 1qnored 
%G 1qnored 
%~H special character 
AN neg. line feedsmoves up one line 
aJ decreases current character size by one 
%K increases current character size by one 


Due to the extended character set available onthe 
vector general, all special character symbols are pre-e 
ceded by a percent sign. In order to have a percent 
SIQN appear on the screen, two percent sians (44) must 
apoear in the character string. A list of the special 
characters availablie are listed on the next page under 
Extended Character Set. 


DIAGNOSTICS: 


All errors will oe printed = on the PDP=-11 terminal 
screen. 


Error - E02 - The space allocated for the building 
of elements has been exceeded. 

Error = E04 = Incorrect ASCII character symbol 
found in character string. 

Error = E09 |= Maximum number of elements 
per picture exceeded. 
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charele charele 


Extended Character Set 


KEYBOARD CHARACTER 


SYMBOL 


aspace 


n% 


VN & S< & OC)= =a 


%a 10 
%+ Ts 
he = 
4° — 
oe => 
A = 
40 © 
“1 a 
42 wi 
“3 B 
%4 ¢ 
y Ave: A 


T> 





charele charele 


x 
Oo 
Th rl vyr> ®- © Me TAH es EP xX + D> CHRO 


é 


w 
> 
7 


w 
t 

o 

# 
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charele 


charele 


J 


Y¥~m pw ven p 4 w 


a 


yi \ «~ x 2D 3 


F WQ b&b & 


4U 


AV 


ay 


TH 





charele charele 


alee 4 w 
%{ ¥ 
%! 


= 
aL 


: 
t 
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circle circle 


i 


NAME: 


circle = draw a circle 


SYNOPSIS: 
circle(dir,svcentx [s,centy] [lrcentz] ) 


dirs CC / 004 = counter clockwise 
C / 010 = clockwise 


float centx [,centy] ls,centz2) ; 


DESCRIPTION: 


A circle is drawn from the oresent beam location about 
the indicated center point. ; 
The parameters passed for the center point of the cire 
cle are either relative or absolute values. The 
number and value of these Darameters are determined by 
the vector type selected in the previous cal] to sete 
vector. 


Circles cannot be drawn by anv of the four incrementa!l 
vectors. 


DIAGNOSTICS: 


All error messages will be printed on the PDPe-11 tere 
minal screen. 


EQ1 = This routine has been called outside 
of a draw element block. 

Error = EQ2 = The space allocated for the buildina 
of elements has been exceeded. 

Error = E03 = The draw direction was not defined 
as either C or CC, 

Error = E15 = The x value was out of bounds. 

Error = E16 = The y value was out of bounds. 

Error = E11? = The z value was out of bounds. 

Error = E19 = Tlliegal arec/circle instruction 

from an incremental vector. 


21g lolly 


mies) SEE: 


setvector °* gives parameter requirements for each 
vector type. 
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coordsys coordsys 


NAME: 


coordsys = define user coordinate system 


SYNOPSIS: 
coordsysl(dimsminxsmaxxeminysmaxy Creminzemaxz] );3 
int dims 


float minxsmaxxesminyrmaxy [,minz,maxz] 3; 


DESCRIPTION: 


Defines a two or three dimensional cartesian coordi- 
nate system, of any scale, for the user. The parameter 
dim specifies the number of dimensions required. I f 
dim is 2 then only the range of x and y need to be 
specified. 


minx must be strictly less than maxx. 
miny must be strictly less than maxy. 
minz must be strictly less than maxz. 


All subseauent user coordinate values are interpreted 
according to this user defined coordinate system. 


If coordsys is not called by the user the default 
values will be taken. The default coordinate system is 
three dimensional with xr yr 2 ranging from -“100.0 to 
100.0. All coordinate values received will be inter= 
preted according to these default values unless” the 
coordinate system 1s redefined by the user. 


DIAGNOSTICS: 


Any values which fall] outside of the defined coordi- 
nate system will be  iqnored and an error message 
specifyina which coordinate values were out of range 
will be printed on the PDP-11 terminal screen. 
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copyele copyele 


NAME 


copyele = specify additional names to be used 
in referencing a specific element block 


SYNOPSIS: 
copyele(nums,"“elename","namel","namec",...)7 


int num; 


DESCRIPTION: 


This routine allows the user to give several unique 
names to a specific element block. In this manners a 
user can Tink one element to an object several times 
and can uniquely reference each occurrence of the 
element within the object. 


num specifies the number of element names veing passed 
in this routiner num can vary between 1 and 10. 
DIAGNOSTICS: 


All error messaqes will be eprinted on the PDPA-11 ter= 
minal screen. 


Error = E06 *= Unknown element name. 
Error = E07 Duplicate element name. 
Error = E18 = Value num not between 1-10. 


Sis0 SEE: 


draweler, object 
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drawele drawele 


NAME $ 


dGrawele = start a draw element block 


SYNOPSIS: 


drawele("*elename"); 


DESCRIPTIONS 


This routine specifies the beqinnina of a draw element 
block. It associates a unique name with the group of 
draw instructions that fall in between this call and a 
call to endele. The resulting picture segment will 
then be referenced by the name specified, as the eleo- 
ment mame, in this routine. 


A user may want to repeat a specific element block 
structure several times within one object. Instead of 
specifyina several element blocks which describe the 
Same structure a user can indicate a group of names 
which refer to one snecific element block. These 
unique names each referring to the same structure can 
then be linked to an object, and each can be uniquely 
referenced. This association of several names with one 
element can be accomplished by the routine copyele. 


DIAGNOSTICS: 


All error messages will be orinted on the PDP#11 ter- 
minal screen. 


Error * E01 = This routine has been called outside 
of a draw element block. 

Error = E02 - The space allocated for the building 
of elements has been exceeded. 

Error = E07 = Duplicate element name. 


ALSO SEE: 


copyeles object 
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endele endele 


NAME: 
endele = end of the current element block 

SYNOPSIS: 
endele(); 

DESCRIPTIONS 
Specifies the termination of a list of draw instruc- 
tions describing a specific element. The picture seg- 
ment described by this group of draw instructions, 
that fall between a drawele and endele calls will be 
referenced by name specified in the drawele. 
A new element block cannot begin until the previous 
Bock has been oroperly terminated by a call to 
endele. 

DIAGNOSTICS: 


This routine must be called to properly end a draw 
element block. If a block is not properly terminated 
prior to the beginning of a new element block, al] 
drawele calls will be tqnored and any draw instruc- 
tions that follow will be associated with the element 
block that has not been terminated. 


All error messages will be printed on the PDP-11 ter- 
minal screen. 


Error = EOL = This routine has been called outside 
of a draw element block. 

Error = E02 = The soace allocated for the buildina 
of elements has been exceeded. 
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erase 


NAME 


erase 


erase = erase the specified portions of the picture 


SYNOPSIS: 


Parameter values: 


PIC / Q0 
OBJ / =1 


To erase the entire pictures: 
erase (PIC); 
To erase a specific object: 
erase (OBJ,"objname"); 
To erase elements of a specific object: 


erase(num,"objname","elel","elee",..J3 
Int num; 


PESCRIPTIONS 


The entire oicture, specified object or the listed 
elements of a specific object, will be erased from the 
vector general display screen. The elements still 
exist. To redisolay any portion of the erased picture, 
the appropriate elementeobject JTinking must again be 
done by the user. 


num specifies the number of element nmames being passed 
in this routine. 


DIAGNOSTICS: 


All error messages wil! be printed on the PDPell tere 
minal screen. ‘ 


Error = E05 = Unknown object name. 

Error = E06 = Unknown element name. 

Error = ELI8 = Value num not between 1-10. 

Error E21 = Element not associated with 
the named object. 


eizoO SEE: 


remove 
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errormsg errormsag 


NAME: 


errormsg * print error messages on PDPe-11 terminal 
screen 


SYNOPSIS: 
errormsglaction); 
action: 
ON / O1 = print errors on PDP-1i1 terminal 
OFF / 00 = stoo printing of error mesSsaaqges 
DESCRIPTIONS 
All error messaaes will] automatically be printed on 
the PDPe-11 terminal screen. The user can control the 


orinting of error messages during any portion of a 
OProaram by calling this routine. 
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indata 


NAME $ 
indata = input data from the vector general 
keyboard 
SYNOPSIS: 
indata(buffer,s,lenath,xpos,yoos); 
char *buffer; 
int lenath, 


float xposrypos, 


DESCRIPTION: 


Indata 


This routine allows the user to enter data from the 
vector general keyboard onto the vector general 


disolay screen beginnina at the position indica 
XPOS? YyOOSe The data, ASCII character codes, 


ted by 
will 


also be placed in the user buffer specified by buffer. 


The length of the user buffer must be specifed b 
parameter length. A cursor will be displayed 
initial position and all data will remain o 
display screen until a carriage return is ente 
the user. All data placed in the user's’ buffer 
remain unaltered. 


A listing of the ASCII character code for every 
board entry is listed on the next page. 


DIAGNOSTICS: 


All error messages will be printed on the PDP -1 
minal screen. 


Error = E15 = The x value was out of bounds. 
Error = E16 = The y value was out of bounds. 


y the 
at the 
n the 
red by 

wil] 


key= 


1 tere 


Error = E20 = User buffer dimensioned to small. 


B86 





indata 


OCTAL 
CODE 


000 
001 
002 
003 
004 
005 
006 
007 
010 
011 
Ole 
013 


CHARACTER 


(i +e eZ N FT CON HA HK Few 


“~ 6 


GENERATED 


SYMBOL 


(ianored) 


last char. 


(iyanored) 
(ignored) 
(ignored) 
(19nNoOred) 
(iqnored) 
(ianored) 


(LF, cent) 


(top, cent) 
(top, left) 


(CR, LF) 
(ianored) 
(ianored) 


(clear aueue) 


(-LF) 
(-SZ) 
(+SZ) 


(terminate) 


(ianored) 
(ianored) 
(ianored) 
(1anored) 
(iqnored) 
(ianored) 
(escape) 

(yanored) 
(iaqnored) 
(iaqnored) 
(yanored) 
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KEYBOARD 


SYMBOL 


a AMoOOoO DY go 


=< CAMNDO VIO Z 


tr>~ wee ODNUNKATNEWYeY Dieter, 2 eee 


one 


Ctr 
ctr] 
ctrl 
ctr] 
ctr] 
ctr 
Ctr 
et! 


indata 





indata 


061 
062 
063 
064 
065 
066 
067 
070 
071 
072 
073 
074 
075 
076 
077 
100 
101 
102 
103 
104 
105 
106 


oT PH YL aN<K EKMCAWNDOIVOZ FF KUM TONAMIINDDSEAWVWN A.W! ODINTKHEWNR 


aon Jo 


(sub,sunerscript) 
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oT siie! aa PHS ONKXKEKCANDDVOZ EC KUHN TANMINDTE we trv rw ODINTNEWNe 


shift 
shift 
shift 


shift 
shift 
shift 
shift 
shift 
shift 
Shinn 
shift 
shift 
shift 
shift 
shift 
shift 
shift 
shift 
shift 
shift 
shift 
shift 
shift 
shift 
Situ 
shift 
Siistat t 
shite 
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shift 
shift 
shift 
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shift 
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shift 
shift 
shift 
shift 
shift 
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shift 
shift 
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shift 
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shift 
shift 
shift 
shift 
shift 
shift 
shift 
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shift 
shift 
shift 
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shift 
shift 
shift 
shift 
shift 
shift 
shift 
shift 
Shit t 
shift 
shift 
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shift 
shift 
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shift 
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shift 
shift 
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shift 
shift 
shift 
shift 
shift 
shift 
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spec 


spec 
spec 
spec 
spec 
spec 
spec 
spec 
spec 
spec 
Spec 
spec 
spec 
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spec 
spec 
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intoffset intoffset 


NAME $ 
intoffset = object intensity offset 

SYNOPSIS: 
intoffset("objname",val); 
float val; 

DESCRIPTION: 
The intensity ranae of the specified object is deter- 
mined by the parameter val. If val 31s oner the maxe- 
imum intensity range is achieved. If the value is 
ZerO,r the intensity 1s constant and the image has no 
depth=cueing. 

DIAGNOSTICS: 
All error messages will be printed on the PDPell1l tere= 
minal screen. 

Error 7 E05 = Unknown object name. 
Mies SEE: 


intscale 
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intscale 


NAMEs$ 


intscale 


intscale = modify object intensity scale 


SYNOPSIS: 


intscale("objname",val)? 


float val; 


DESCRIPTIONS: 


The intensity range of an objects which gives a three 
dimensional object its depth cueings 318 determined by 
the parameter val. The range of val is from zero to 
one. If val 18 one the maximum intensity range is 
obtained, 1f it 18 zero the object has no depth cuee- 


1NGe 


DIAGNOSTICS: 


All error messages will be printed on the PDP-11 tere 
minal screen. 


Error = E0S |= Unknown object name. 


peo SEE: 


intoffset 


93 





lghtpen Yghtpen 


NAME 
Ightpen = set lightpen hookability of 
the picturer,object or elements 
SYNOPSIS: 
actions 
ON / 01 = Set light pen hookability 
OFF / 00 = Clear light pen hookability 
Parameter values: 
PIG 37 200 
OBJ / -1 

To set hookability of the entire picture: 
Tghtpen(Caction,PIC); 

To set hookability of an object: 
Ightoen(action-,CBJ,"objname"); 

To set hookability of elements of a specific object: 
Ightpenlactionrsnum,"objname","elel","elec",...)3 
mt num? 

DESCRIPTION: 


The user can specify which picture segments will] be 
light pen hookable. These elements designated as light 
pen hookable will be effected by liaht pen interaction 
.with the vector general disolay screen. 


num specifies the number of element names being passed 
in this routines, num can vary between 1 and 10. 


DIAGNOSTICS: 


All errors will be printed on the PODPe-11 termina] 
screen. 


Error = E05 = Unknown object name. 
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lghtpen Ightpen 


Error = E06 = Unknown element name. 

Error = E18 = Value num not between 1-10. 

Error *- E2l = Element not associated with 
the named object. 
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line 


line 


NAME: 
line - draw a line 
SYNOPSIS: 
line€Cparx (-,pary) C,parz) 3); 
float parx f,oary) (-,parz] 73 
DESCRIPTIONS: 
A line is drawn to the location specified by the xryrz 
coordinate values. The values may specify actual absoo 
lute coordinate points or an incremental value which 
will be added to or subtracted from the previous xryr2 
coordinate point. The number of oarameters and their 
values are determined by the vector type specified in 
the preceding call to setvector,. 
DIAGNOSTICS: 
Al) error messages will be printed on the PDP#11 tere 
minal screen. 
Error = E01 -2¢ This routine has been called outside 
of a draw element block. 
Error 2- E02 - The space allocated for the building 
of elements has been exceeded. 
Frror *- E15 = The x value was out of bounds. 
Error *- £16 ©- The y value was out of bounds. 
Error © El7v © The z value was out of bounds. 
Boo SEE: 


setvector 


- gives parameter requirements for each 


vector type. 
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move 


an incremental value 


move 
NAME: 
move = move to the specified location 
SYNOPSIS: 
move(oarx (,pary) [,parz] ); 
float parx [,pary) [s,narz] 7; 
DESCRIPTION: 
The beam is moved to the location specified by the 
XxeYr,zZ Coordinate values. The values may specify actual] 
absolute coordinate points or 
which will be added to or subtracted form the previous 
XeYr,zZ Coordinate values. The number of parameters and 
their values are determined by the vector type specie 
fied in the preceding cal!) to setvector. 
DIAGNOSTIC: 
All error messages will be printed on the PDP-1ll tere 
minal screen. 
Error = E01 2 This routine has been called outside 
of a draw element block. 
Error - E02 = The space allocated for the buildina 
of elements has been exceeded. 
Error = E15 = The x value was out of bounds. 
Error = E16 = The y value was out of bounds. 
Error *- E17 |= The 2 value was out of bounds. 
meoQ SEE: 


setvector *= gives parameter requirements for each 


vector tyoe. 
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object : object 


NAME: 
object = link elements to specified object name 
SYNOPSIS: 
object (numr"objname","elel","“elee"s.eee)2 
int num? 
DESCRIPTION: 
Associates with the named object each of the listed 
elements. This picture segment, or element grouping 
will be referenced by the object name specified in 
this routine. 
Every element must be linked to at least one object 
inorder for it to be displayed on the vector aqeneral 
screen. A user can link one or more element names to 
an object. Elements can be linked to an object by one 
or several calls to this routine. An element can be 
linked to several different objects, or one element 
may be linked several times to the same object. 
If an object or etement has been erased from the 
display screen, a user can redisplay the desired obe- 
ject or elements by aqain establishing the desired 
objectrelement association. 
num specifies the number of element names being passed 
in this routiner’ num can vary between 1 and 10. 
DIAGNOSTICS: 
All error messages will be printed on the POP-11 ter- 
minal screen. 
Error - E0S |= Unknown object name. 
Error = E06 = Unknown element name. 
Error = E08 = Number of elements allowed 
per picture exceeded. 
~ Error = E09 |= Maximum number of objects 
allowed cer picture (10) exceeded. 
moo SEES 


drawele, copyele 
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remove remove 


NAME: 
remove *- erase the indicated portion of the picture 
and remove the associated elements from 
memory 
SYNOPSIS: 
Parameter values: 
PIC / QO 
To remove the entire picture: 
remove(PIC); 
To remove element structures 3: 
remove(num,"elel","elec"s.e)3 
int nume 
DESCRIPTIONS 
The entire picture, or every occurrence of the named 
elements are erased from the vector qeneral display 
screen. Each name element structure will be removed 
from memory. 
To redisplay any portion of the removed picture ree 
quires” that the user rebuild each element and relink 
it to the aopropriate objects. 
num specifies the number of element names being passed 
in this routine. 
DIAGNOSTICS: 
All error messaaqes will be printed on the PDP-11 tere- 
minal screen. 
Error = E05 |= Unknown object name. 
Error = E06 |= Unknown element name. 
Error = E18 © Value num not between 1-10. 
Error - E21 = Element not associated with 
the named object. 
ReoO SEE: 
erase 
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rotate rotate 


NAME s 
rotate = rotate an object 

SYNOPSIS: 
rotate("objname",xradians,s,yradians [,zradians] ); 
float xradiansrsyradians (s,zradians] ; 

DESCRIPTIONS: 
The named object will be rotated about the x», yor 2 
coordinate axis. The parameters, given in radian meas- 
ure, specify the degree of rotation desired about each 
axiSe 
The 2 parameter tis required only when the coordinate 
System is defined as three dimensional and will be 
ignored otherwise. 

DIAGNOSTICS: 


All error messages wil! be printed on the PDP#-11 ter- 
minal screen. 


Error = E05 = Unknown object name. 
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scale scale 


NAME: 
scale = modify object scale 

SYNOPSIS: 
scale(“objmname", scale); 
float scale; 

DESCRIPTION: 
All elements associated with the named obdject' are 
scaled by the value scale at display time. The range 
of scale is from zero to onee If not established by a 
user this value automatically defaults to ones which 
is the maximum poicture scale. 

DIAGNOSTICS: 


All error messaaes wil! be printed on the PDPe-l1il ter- 
minal screen. 


Error = E0S = Unknown object name. 
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setvector setvector 


setvector *= specify the vector type and vector mode 


SYNOPSIS: 


setvector(vtype,s,vmode [-r,inc) (,scale] ), 


vtypes 
VR = vector relative 
VRX = vector relative autoztincrement x 
VRY = vector relative autorincrement y 
VRZ = vector relative autortincrement 2z 
VA = vector absolute 
VAX = vector absolute autorincrement x 
VAY = vector absolute autozincrement y 
VAZ = vector absolute autotincrement 2 
INC2 = vector incremental 2-dimensional 
INCX = vector incremental autotincrement x 
INCY = vector incremental autorincrement y 
INC3 = vector incremental 3edimensional 
vmodes: 
LN f 00 = line 
DSH / 020 = dashed line 
DOT / 040 = dotted line 
PNT / 060 = end point 
DDB /0120 = dashw-dotedash line 
DOD /0140 = dashe=dotedash line 
scales: 


MG / 000 = add the coordinate increments 
to the high order bits of the 
specified register. 

NMG /0200 = add the coordinate increments 
to the low order bits of the 
specified register. 


float inc? 


BEOCRIPTION: 


This routine specifies which one of the 12 vector 
types is to be drawn in the line, move, circle and are 
instructions which follow. It also specifies the vec- 
tor mode (i.@e,r line, dotted, dashed, etc.), and if 
required, the increment value for autowincrement vec- 
tors and the scale factor for incremental vectors. 
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setvector setvector 


The coordinate values passed in the _ following draw 
instructions are dependent on the vector type selected 
in this routine. 


This must follow a3 drawele call and preced any draw 
instructions. This routine can be called any number of 
times within a draw element block. 


The bracketed 2 parameters are required only when” the 
coordinate system has been defined as three dimension-= 
al. 


DIAGNOSTICS: 


All error messages wil! be printed on the PDP-11 tere 
minal screen. 


EQ1 = This routine has been called outside 
of a draw element block. 

Error = E02 |= The soace allocated for the building 
of elements has been exceeded. 

Error *- E13 = Vector type undefined. 

Error = E15 - The x value was out of bounds. 

Error - E16 = The y value was out of bounds. 

Error = E17 = The z value was out of bounds. 

Error - E19 © Illegal arc/cirele instruction 

from an incremental vector. 


Error 
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setvector = VA setvector = VA 


NAME: 
VA = vector absolute 
SYNOPSIS: 
drawele("elename”"); 
setvector(VA,vmode); 
move(coordx,coordy [-,coordz] ); 
line(coordx,coordy [,coordz] ; 
circle(dirrcentx,centy [r,centz}] ); 
arc(dir-,centx,centy [,centz],endx,endy [rendz}]); 
endele(); 
float coordx,coordy [,coord2] ; 
float centx,centy [,centz] ,endx,endy [r,endz); 
DESCRIPTIONS: 
The xvryr,2 coordinates of absolute vectors are specia= 
fied with respect to the origins or zero position of 
the user defined coordinate system. Each x» yr 2 coor? 
dinate value references a unique point on the display 
screen. 
DIAGNOSTICS: 


All error messages will be printed on the PODP-11 tere 
minal screen. 


Error = E01 - This routine has been called outside 
of a draw element block. 

Error 7- E02 = The space allocated for the building 
of elements has been exceeded. 

Error = E13 = Vector type undefined. 

Error = EIS = The x value was out of bounds. 

Error = E16 = The y value was out of bounds. 

Error = Et? = The z value was out of bounds. 
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setvector = VAX setvector =VAX 


NAME 
VAX = vector absolute autotincrement «x 
SYNOPSIS: 
drawele("elename"); 
setvector(VAX,vmoderxinc); 
move(coordy [,coordz) ); 
move(coordy [scoord2]) )3 
circle(dir,scenty [r,cent2) ); 
arc(dir,centy [rcentz) rendy [fr,endz]) ); 
endele(); 
float xinc, coordy [,coordz]) ; 
float centy [(,centz] ,endy [(,endz]; 
DESCRIPTION: 
The vector absolute autotincrement x causes the ini-o 
tial «x coordinate value to be incremented or decre=- 
mented by the value specified by xinc. With every 
move, lines arcr or circle command the specified y and 
Z coordinate values are updated while the x coordinate 
value is stepped by the constant value xinc. For 
example, the point(x, yr, 2) becomes point(xtxinc, 
coordy, coord2). 
The value of xine cannot exceed the range of the deo 
fined coordinate system. 
DIAGNOSTICS: 


Al] error messages will be printed on the PDP-11 ter- 
minal screen. 


Error = E01 This routine has been called outside 

of a draw element block. 

Error = E02 = The space allocated for the building 
of elements has been exceeded. 

Error = E13 = Vector type undefined. 

Error = E14 = The increment value was out of 
bDouNAdS. 

Error = E16 = The y value was out of bounds. 

Error = El? = The 2 value was out of bounds. 
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setvector = VAY setvector = VAY 
NAME $ 
VAY = vector absolute autozwincrement y 
SYNOPSIS: 
drawele("“elename"); 
setvector(VAY,vmoderyinc);3 
move(coordx {-rcoordz2] );3 
line(coordx [-,coordz)] ); 
circle(dirrecentx [,cent2z] )3 
arc(dir,scentx [r,centz],endx [{,endz] ); 
endele(); 
float yincrcoordx [,coordz) ; 
float centx {-,centz] -,endx [,endz]; 
DESCRIPTIONS: 
The vector absolute autotincrement y causes the jinicg 
tial y coordinate value to be incremented or decre- 
mented by the value specified by yinc. With every 
mover liner arc or circle command the specified x and 
z coordinate values are updated while the y coordinate 
value is stepped by the constant value yinc. For 
example, the point(xryrz2) becomes point (coordxrytyincs 
coordz). 
The value of yine cannot exceed the range of the deo- 
fined coordinate system. 
DIAGNOSTICS: 


Al) error messages wil) be printed on the PDP-11 
minal screen. 


ter- 


Error = E01 - This routine has been called outside 


of a draw element block. 


Error = E02 =- The space allocated for the building 


of elements has been exceeded. 
Error = E13 = Vector type undefined. 
Error = E14 = The increment value was out of 
bounds. 
Error = E15 - The x value was out of bounds. 
Error = E17 |= The z value was out of bounds. 
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setvector 7 VAZ setvector = VAZ 


NAME: 
VAZ = vector absolute autorincrement 2 
SYNOPSIS: 
drawele("“elename"); 
setvector(VAZ,vmode,z2inc)?: 
move lcoordx,coordy); 
line lCcoordx,coordy); 
\ circle(dirrcentx,centy): 
arc(dir,centxr,centyrendx,endy), 
endele(); 
float zinercoordx-,coordys 
float centx,centyrendx,endy, 
DESCRIPTION: 
The vector absolute autotincerement z causes’ the inie 
tial Z coordinate value to be ineremented or decree 
mented by the value specified by 2zince With every 
MOVE, liners are or circle command the specified x and 
y coordinate values are updated while the 2 coordinate 
value is stepped by the constant value zince For 
example the point(x,y-r2) becomes point (coordx,coordy,2z 
+z1inc). 
The value of zine cannot exceed the ranae of the dee 
fined coordinate system. 
DIAGNOSTICS: 


All error messages will be printed on the POP=11 ter- 
minal screen. 


Error = E01 © This routine has been called outside 
of a draw element block. 

Error = E02 = The space allocated for the building 
of elements has been exceeded. 

Error = E13 © Vector type undefined. 

Error = E14 |= The jincrement value was out of 
bounds. 

Error =~ E15 = The x value was out of bounds. 

Error = E16 = The y value was out of bounds. 
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setvector = VR setvector = VR 
NAMEs VR = vector relative 


SYNOPSIS: 


drawele("elename"); 
setvector(VR,vmode); 
move(deltax,deltay [,deltaz) ); 
line(deltax,deltay (,deltaz]) ; 
circle(dir-,centx,centy,s [cent2]) )- 
arc(dir,centx,centyls,centz)] ,endx,endyleendz]} ); 


endele(); 


float deltax,deltay [,deltaz] ; 
float centxrcenty [rcentz]) ,endx,endy [rendz]; 


DESCRIPTION: 


Relative vectors specify a increment value that is to 
be added to or subtracted from the initial xryr,2z abson- 
lute coordinate values. For example, the point(xry,2) 
becomes point(x+tdeltax, ytdeltay,z+deltaz). 


The parameter values cannot exceed the range of the 
defined coordinate system. 


DIAGNOSTICS: 


Al] error messages will be printed on the PDPell tere 
minal screen. 


Error = E01 © This routine has been called outside 
of a draw element block. 

Error = E02 = The space allocated for the building 
of elements has been exceeded. 

Error = E13 = Vector type undefined. 

Error = E15 = The x value was out of bounds. 

Error = E16 = The y value was out of bounds. 

Error *= E17 = The z value was out of tounds. 


108 





setvector = VRX setvector 


- VRX 


NAMES: 
VRX = vector relative autotinerement x 
SYNOPSIS: 
drawele("*elename"); 
setvector(VRX,vmode,xinc) 
move(deltay (,deltaz] ); 
line(deltay (,deltaz] ); 
circle(dirercenty [f,centz]); 
arc(dir,centy [(,centz])r,endy (,endz)]); 
endele(); 
float xincr,deltay (C,deltaz]) ; 
float centy ([,centz],endy [,endz]; 
DESCRIPTIONS: 
A vector relative autozwincrement x causes the initial 
x coordinate value to be incremented or decremented by 
the constant value xinc. With every move, line, arc 
or circle instruction that follows, the y and 2 coor- 
dinate values will be updated, while x iS stepped Dy 
the value xinc. For examoler the point(xryr,2) becomes 
point(x+t+txinc,ytdeltay,ztdeltaz). 
The parameter values cannot exceed the range of the 
defined coordinate system, 
DIAGNOSTICS: 


All error messages will be orinted on the PDP -11 
minal screen. 


ter= 


Error = EQ1 = This routine has been called outside 


of a draw element block. 


Error 2* E02 = The soace allocated for the building 


of elements has been exceeded. 
Error 2= E13 = Vector type undefined. 
Error - E14 = The increment value was out of 
dnounds. 
Error = E16 *= The y value was out of bounds. 
Error = E17 = The 2 value was out of bounds. 
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setvector = VRY setvector 


o VRY 


NAME: 
VRY = vector relative autowincrement y 
SYNOPSIS: 
drawele("elename"); 
setvector(VRY,vmode;,yinc) 
move(deltax [(,deltaz] )3 
line(deltax (,deltaz] ); 
circle(dir,centx [,cent2] ); 
arc(dir,centx [,centz]),endx [,endz}]); 
endele(); 
float yincr,deltax [,deltaz] ; 
float centx [,cent2z),endx lr,endz]; 
DESCRIPTIONS 
A vector relative autowincrement y causes the initial 
y coordinate value to be itneremented or decremented by 
the constant value yinc. With every move, line, are 
or circle instruction that follows, the x and 2 coore 
dinate values will be undated, while y iS stepped by 
the value yince For example, the point(x,yr,z) becomes 
point(xtdeltaxr,ytyinc,ztdeltaz). 
The parameter values cannot exceed the range of the 
defined coordinate system. 
DIAGNOSTICS: 


All error messages will be printed on the PDP-11 
minal screen. 


tere 


Error = E01 *- This routine has been called outside 


of a draw element block. 


Error = E02 = The space allocated for the buildina 


of elements has been exceeded. 
Error = E13 = Vector type undefined. 
Error = E14 = The increment value was out of 
bounds. 
Error = E15 = The x value was out of bounds. 
Error = E17 = The z value was out of bounds. 
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setvector = VRZ | setvector 


VRZ 


NAMEs 
VRZ = vector relative autortincrement 2 
SYNOPSIS: 
drawele("*elename"); 
setvector(VRZ,vmode,zinc) 
move(deltax, deltay); 
line(deltax ,deltay); 
circle(dir-centx,centy); 
arc(dir,centxr,centy,endxr,endy); 
endele(),; 
float zinc,deltax,deltay, 
float centxr,centyrendx,endy; 
DESCRIPTION: 
A vector relative autotincrement z causes the initial 
2 coordinate value to be incremented or decremented by 
the constant value zinc. With every move, line, arc 
or circle instruction that follows, the x and y coore 
dinate values will be updated, while 2 is stepnmed by 
the value Z2inc. For example, the point(x,y,2) becomes 
point(x+deltax,ytdeltay,ztincz). 
The parameter values cannot exceed the range of the 
defined coordinate system. 
DIAGNOSTICS: 


All error messages will be printed on the PDP-11 
minal screen. 


tere 


Error - E01 = This routine has been called outside 


of a draw element block. 


Error = E02 = The space allocated for the building 


of elements has been exceeded. 
Error = E13 |= Vector type undefined. 
Error = E14 = The increment value was out of 
bounds. 
Error = E15 = The x value was out of bounds. 
Error + E16 = The y value was out of bounds. 
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setvector *= INC2 setvector 


NAME: 


INC? = incremental vector ¢ two dimensional 


SYNOPSIS: 


drawele("elename"); 


setvector(INCe,vmode,scale)? 
move(deltax,deltay)? 
line(deltax,deltay); 


endele(); 
float deltax,deltay; 


scales: 
MG - add the coordinate increments to the 7 


INCe 


high order bits of the specified register. 


NMG= add the coordinate increments to the 7 


low order bits of the specified register. 


DESCRIPTION: 


A two dimensional relative vector, that halves 


vector 


storage requirements and doubles the data rate. 


vector type should be used when element storaqe 


This 
space 


is critical. This reduced storage requirement results 
from a limitation on the maximum size of each relative 
increment. The values passed in line or move instruce 


tions are limited to aoproximately 3% of the 


user 


minimum and maximum coordinate ranges. The parameter, 


scale, specifies if this Increment value should 


be 


added to the 7 high order bits of the specified coor- 
factor 
then determines if the increments will be applied over 


dinate or to the 7 low order bits. This’ scale 


a fine(NMG) or coarse(MG) grid. 


Arcs and circles cannot be drawn with this vector 


type. 


DIAGNOSTICS: 


All error messages will be orinted on the PDPe-1! 
minal screen. 


cer 


Error = E01 = This routine has been called outside 


lie 





setvector 


- INCe 


Error 


Error 
Error 
Error 
Error 


Evia 


E13 
E15 
E16 
aly, 


setvector 


of a draw element block. 
The space allocated for the building 
of elements has been exceeded, 
Vector type undefined. 

The x value was out of bounds. 
The y value was out of bounds. 


Illegal 
from an 


tis 


arc/circle 
incrementa] 


instruction 
vector. 


INCe 





setvector = INCX setvector 


NAME s 


INCX = incremental vector ,-stwo dimensional 
autorincrement x 


SYNOPSIS: 


drawele("elename"); 
td 


setvector(INCX,vmode,xinc,scale); 
move(deltay,deltay); 
line(deltay,deltay); 


endele(); 
float xinc,deltay; 


scales 
MG = add the coordinate increments to the 7 


INCX 


high order bits of the specified reaister. 


NMG= add the coordinate increments to the 7? 


low order bits of the specified register. 


DESCRIPTION: 


A two dimensional relative vector, that halves vector 


storace requirements and doubles the data rate. 


This 


vector type should be used when element storage space 
is critical. This reduced storage requirement results 
from a limitation on the maximum size of each relative 
increment. The values passed in line or move instruc 
tions are limited to aporoximately 3% of the user 
minimum and maximum coordinate ranges. The parameter, 
scale, specifies if this increment value should be 


added to the 7 hiah order bits of the specified 


COOr* 


dinate or to the 7 low order bits. This scale factor 
then determines 1f the increments wil! be applied over 


a fine(NMG) or coarse(MG) grid. 


This incremental, auto increment vector causes 


the x 


coordinate value to be incremented or decremented by 


the constant value xinc, while the y coordinate 
is increment by small relative values. 


Arcs and circles cannot be drawn with this 
type. 


value 


vector 
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DIAGNOSTICS: 


setvector 


= 


All error messages will be printed on the PDP-1 
minal screen. 


Error 
Error 


Error 
Error 


Error 
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- E02 
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- INCX 


1 tere 


This routine has been called outside 


of a draw element block. 


The space allocated for the building 


of elements has been exceeded. 
Vector type undefined. 

The increment value was out of 
bounds. 

The y value was out of bounds. 
Illegal arc/circle instruction 
from an incremental vector. 
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NAME: 
INCY = incremental vector -two dimensional 
autosinerement y 
SYNOPSIS: 
drawele("elename"); 
setvector(CINCY,vmoderyinc,scale), 
move(deltax,deltax); 
line(deltax,deltax); 
endele(); 
float yinc,deltax; 
scales 
MG = add the coordinate increments to the 7 
high order bits of the specified register. 
NMG= add the coordinate increments to the 7 
low order bits of the specified register. 
DESCRIPTION: 


A two dimensional relative vector, that halves vector 
storage requirements and doubles the data rate. This 
vector type should be used when element storage space 
is critical. This reduced storage requirement results 
from a limitation on the maximum size of each relative 
increment. The values passed in line or move instruc 
tions are limited to approximately 3% of the user 
minimum and maximum coordinate ranges. The parameter, 
scale, specifies if this ianerement value should be 
added to the 7 high order bits of the specified coor- 
dinate or to the 7 low order bits. This scale factor 
then determines if the increments will be applied over 
a fine(NMG) or coarse(MG) grid. 


This incremental, auto increment vector causes the_ y 
coordinate value to be incremented or decremented by 
the constant value xinc, while the y coordinate value 
is increment by small relative values. 


Arcs and circles cannot be drawn with this vector 
type. 
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DIAGNOSTICS: 


setvector 


All error messages will be printed on the PDPel 
minal screen. 


Error 
Error 


Error 
Error 


Error 
Error 


EO1 
E02 


E13 
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1 tere 


This routine has been called outside 


of a draw element block. 


The space allocated for the building 


of elements has heen exceeded. 
Vector type undefined. 

The increment value was out of 
bounds. 

The x value was out of bounds. 
Illegal arc/circle instruction 
from an incremental vector. 
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NAME $ 


INC3 = incremental vector ,three dimensional 


SYNOPSIS: 


drawele("elename"); 
setvector(INCX,vmode,scale); 
move(deltax,deltay,deltaz)-; 
line(deltax,deltay,deltaz); 


endele(); 
float deltax,deltay,deltaz, 


scales 
MG = add the coordinate increments to the 7 


INC3 


high order bits of the specified register. 


NMG= add the coordinate increments to the 7 


low order bits of the specified register. 


DESCRIPTIONS 


A three dimensional relative vector, that halves 


vec= 


tor storage requirements and doubles the data rate. 
This vector type should be used when element storaqae 
space is critical. This reduced storage requirement 


results from a limitation on the maximum size of 


each 


relative increment. The values passed in line or move 
instructions are limited to approximately 3% of 
user minimum and maximum coordinate ranges. 


paramater, scaler, specifies if this increment 


the 
The 


value 


should be added to the 7 high order bits of the speci- 


fied coordinate or to the 7 low order bits. 


This 


scale factor then determines if the increments will be 


applied over a fine(NMG) or coarse(MG) grid. 


Arcs and circles cannot be drawn with this vector 


type. 


DIAGNOSTICS: 


All error messaqes will be printed on the PODP-11 
minal screen. 


ei 
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Ernor 
Error 


Error 
Error 
Error 
Error 
Error 


EQ1 
EQe 


E13 
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E16 
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This routine has been called outside 
of a draw element block. : 
The space allocated for the building 
of elements has been exceeded. 
Vector type undefined. 

The x value was out of bounds. 

The y value was out of bounds. 

The z value was out of bounds. 
Tllegal arc/circle instruction 

from an incremental vector. 
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NAME: 
Sysinit = vector general display initialization 
SYNOPSIS: 
sysinit(); 
DESCRIPTIONS: 
This routine establishes a link with the vector gen- 
eral, initializes its display system and sets all the 
user default carameters. 
This routine must be called before any other display 
instructions. 
DIAGNOSTICS: 


If the initialization cannot be properly completed, an 
error message will be printed on the PDP-11 terminal 
and the process will be terminated. This error could 
occur because the vector general 18 being accessed by 
a another user. 
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trans trans 


NAME: 
trans = translate object 

SYNOPSIS: 
trans("objname",x,y (,2) )- 
float xrvy (,2) 3 

DESCRIPTIONS: 
All of the elements associated wtth the named object 
are translated by the amount x», yr Zz at display time. 
Each coordinate point(xX-,Y¥,Z) of the object becomes 
point (X+x,Y¥ty,Z+z) at display time. 
The Z parameter is required only when the coordinate 
system is defined as three dimensional, and wil) be 
ignored if included. 

DIAGNOSTICS: 


All error messages wil] be oprinted on the PDPell tere 
minal screen. 


Error =- £05 = Unknown object name. 


eed 
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